home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 014a / quixx243.zip / README.! < prev   
Text File  |  1991-11-17  |  11KB  |  254 lines
  1. PROGRAM:  Quixx
  2. AUTHOR:   Jonathan Kraidin on 2/90
  3. VERSION:  2.42 on 11/17/91
  4. LAST VER: 2.30 on 08/18/91
  5. USE:      TSR Screen Animator
  6. REQUIRES: DOS 3.0 or above (might work with 2.1 and above, but not tested)
  7.       CGA, EGA, VGA
  8.           Extended or Expanded memory strongly recommended
  9.           CGA = 32K, EGA = 64K, VGA = 160K
  10. SOURCE:   ASSEMBLY
  11.  
  12.  
  13.  
  14. 1. USE:
  15.  
  16.   This is a TSR program that generates a beautiful selection of vapor-
  17.   like trails after a given idle period.  A simple help file can be called by
  18.   typing QUIXX ? at the DOS prompt.  The program is loaded into memory with:
  19.   QUIXX TimeOut Mode
  20.  
  21.   OR
  22.  
  23.   QUIXX Special (after the Quixx is already loaded)
  24.  
  25.   where TimeOut is the idle time in minutes (1 to 99) and Mode is from
  26.   0 to 19. Modes 1 through 15 select a constant color display for the QUIXX
  27.   using a color palatte corresponding to the Mode.  That is Mode 2 = color 2.
  28.  
  29.   Mode 0 selects an alternating color display.  Every time the Quixx pattern
  30.   bounces off of a wall the color increments.  Mode 16 selects a pattern where
  31.   the colors vary within each line of the Quixx pattern.  This yields a
  32.   constantly changing image as the vapor trail moves.  Mode 17 selects the
  33.   same pattern-type, but in VGA mode19, allowing 256 colors.  The resolution is
  34.   320x200.  Mode 18 is also in VGA mode19, but here the lines of the vapor
  35.   trail are solid.  As a new lines are drawn they go go through all 256 colors.
  36.  
  37.   Mode 19 is the Glide mode.  Here the Quixx pattern is one color,
  38.   but as the image moves its color goes through a continuous spectrum of 384
  39.   shades.  THIS IS A GREAT MODE.
  40.  
  41. 2. SUMMARY OF COLOR MODES:
  42.  
  43.    0       Alternating Colors
  44.    1 - 15  Default Colors in Palette
  45.    16      High Resolution Pattern1
  46.    17      Vga Mode19 Pattern1 (320x200)
  47.    18      Vga Mode19 Pattern2
  48.    19      Glide Mode (Recommended Mode)
  49.  
  50. 3. EXAMPLES OF OPTIONS
  51.  
  52.   The options can be changed at any time by retyping the command.  So if you had
  53.   typed:
  54.  
  55.   QUIXX 2 15
  56.  
  57.   selecting a 2 minute time-out using mode 15, and you then type
  58.  
  59.   QUIXX 5
  60.  
  61.   you change the timeout to 5 minutes and leave the mode unchanged.
  62.   If you typed
  63.  
  64.   QUIXX 5 19
  65.  
  66.   you will have also changed the mode to mode 19.
  67.  
  68. 4. UNLOADING THE TSR
  69.  
  70.   If you wish to unload the TSR type
  71.  
  72.   QUIXX r
  73.  
  74.   This will Remove the TSR from the TSR memory chain, regardless of the number
  75.   of TSRs loaded before or after the QUIXX program.
  76.  
  77. 5. ADDITIONS MADE IN NEWER VERSIONS
  78.  
  79.  
  80.   ENABLE/DISABLE ACTIVITY
  81.  
  82.   Version 1.70 includes an enable/disable feature.  This allows Quixx to remain
  83.   in memory as a TSR but remain dormant.  By typing
  84.  
  85.   Quixx -
  86.  
  87.   the user disables the sleep count-down.  The Quixx will never become active.
  88.   By typing
  89.  
  90.   Quixx +
  91.  
  92.   the Quixx's sleep count-down is re-enabled.  One can use this feature in a
  93.   BATCH file if you want to selectively enable/disable the Quixx without
  94.   changing the programs in active memory.  REMEMBER, Quixx's interrupts are
  95.   still hooked into the BIOS.
  96.  
  97.   Version 1.40 adds a HOT-KEY enable/disable feature.  One might be within an
  98.   application and then realize he does not want Quixx to be active; yet, it is
  99.   inconvenient to go back to the command line.  By hitting the ALT key twice
  100.   in rapid succession (ALT ALT) the user can toggle between enabling and
  101.   disabling Quixx from within an application.  For example, if Quixx is active,
  102.   hitting ALT ALT will disable Quixx and the user will hear a quick high
  103.   tone/low tone combination.  By hitting ALT ALT again the user will hear a
  104.   single high-pitch tone reminding him that Quixx is now active.  This is a
  105.   very user friendly option. This option, however, will not work with Windows
  106.   if it uses the mouse and has disabled the keyboard.  In this case, the only
  107.   means of disabling Quixx is from the command line.
  108.  
  109.   SPEED CONTROL OF PATTERN
  110.  
  111.   The program automatically adjusts its pattern speed to your processor.  The
  112.   user can now over-ride this with the speed control in Version 1.71. By typing
  113.  
  114.   Quixx f    OR    Quixx s
  115.  
  116.   the user can speed up or slow down the vapor image. This can be repeated
  117.   multiple times to go really FAST or SLOW.  The user will be informed
  118.   when the limit is reached.  The default speed will be used each time the user
  119.   changes the sleep-period or the image color mode.
  120.  
  121. ******************************************************************************
  122.  
  123. IT IS STRONLY RECOMMENDED THAT YOU HAVE EXPANDED OR EXTENDED MEMORY to prevent
  124. memory conflicts when the TSR saves your video screen.  While the program will
  125. use higher memory without EXPANDED memory, the program may crash your system
  126. depending on what applications are running.  This program has worked well using
  127. Expanded Memory with programs like WordPerfect and Harvard Graphics.
  128.  
  129.  
  130.   EXTENDED MEMORY ADDITION
  131.  
  132.   Version 2.00 now senses and uses extended memory.
  133.   Quixx will first check for the expanded memory driver; if not found,
  134.   quixx will check for the extended memory driver, HIMEM.SYS.
  135.   If none of these are found then High
  136.   Memory is used.  Again, if you see the warning message Quixx can cause
  137.   machine crashes.
  138.  
  139.  
  140.   IF USING EXTENDED MEMORY YOU NEED **** HIMEM.SYS *****
  141.   IF USING EXPANDED YOU NEED AN EXPANDED MEMORY DRIVER MEETING THE LIM SPECS.
  142.   IF YOU DO NOT SEE QUIXX DISPLAY THAT IT RESERVED MEMORY FOR ITSELF THERE
  143.     CAN BE CRASHES!
  144.  
  145. 6.  SPECIAL NOTES
  146.  
  147.    If only a CGA is present only the color white is used.  No other modes work.
  148.    Modes 17, 18, and 19 are meant for the VGA and will not work properly on an
  149.    EGA monitor.
  150.  
  151. 7. MOUSE SENSING
  152.  
  153.    Mouse is sensed at COM1, COM2 and PS/2 port. The port is only checked for
  154.    activity if it is present.  If you are using a Bus Mouse there is a chance
  155.    that your mouse will not be sensed if it is NOT an MS Bus Mouse (InPort
  156.    Mouse) or a Mouse Systems Bus Card.  This is because the mouse protocols
  157.    can be different for each manufacturer.
  158.  
  159.    Because Quixx modifies the execution of its code if a mouse is present
  160.    I suggest that if you are using a mouse to always have the MOUSE.SYS or
  161.    MOUSE.COM file already loaded from your config.sys or autoexec.bat file.
  162.    Otherwise, Quixx may not properly detect your hardware.
  163.  
  164. 8. WINDOWS COMPATABLITY
  165.  
  166.    The program as of the above date has been tested briefly with Windows 3.0.
  167.    If you are using a mouse on COM 1 or 2 (COM or Bus Mouse) or a PS/2 mouse
  168.    it will be 'sensed' when you move it and Quixx will restore your screen.
  169.    The keyboard will not work if you are using a mouse.
  170.  
  171.    Quixx only works with WINDOWS if you have EXTENDED MEMORY.  In addition,
  172.    Quixx must be loaded before WINDOWS in order to reserve the necessary
  173.    memory for its screen saves.
  174.  
  175.    ** Please note ** Version 2.30 includes the memory override option.  This is
  176.    useful if you have both Extended and Expanded memory installed.  By typing
  177.    'Quixx x' you force Quixx to use Extended memory if available; by typing
  178.    'Quixx e' you force Quixx to use Expanded memory.  These options will only
  179.    work if you have the memory driver and enough memory for your monitor type.
  180.  
  181.    ---------------------------------------------------------------------------
  182.    **** Version 2.1 was released so that Quixx would be more completely
  183.    compatible with Windows.  Version 2.03 only worked with Windows in REAL
  184.    mode.  That is, Windows operating like conventional software.  When in
  185.    Enhanced mode, Windows becomes an operating system that puts other programs
  186.    in a virtual environment:  their own universe.  This created a situation
  187.    where Quixx would run, but one could not stop it since the keyboard and
  188.    mouse no longer responded to the user.  Version 2.1 should take care of
  189.    this problem; however, I can not make any guarentees, yet.  I would
  190.    appreciate your input and comments letting me know if this works.  Believe
  191.    me, this took a lot of time and effort. ****
  192.    ----------------------------------------------------------------------------
  193.  
  194.    If you are having problems with Windows I suggest you make a BATCH file to
  195.    remove/load Quixx when entering/exiting Windows.  If you are
  196.    EXITING Windows (whether you have a mouse or not) you should use a
  197.    BATCH file that will REMOVE Quixx from memory (Quixx r) and then
  198.    RE-INSTALL it after you are done with Windows. 
  199.  
  200. 9.  OTHER APPLICATIONS
  201.  
  202.    Version 2.11 was developed such that the user can move in and out of
  203.    applications without worrying about conflicts.  A user can be running
  204.    a CAD application and then move to another without worrying about the
  205.    Quixx TSR.  However, I can not test Quixx with all applications.  There
  206.    may be some incompatibilities.  If so, please mail me a letter stating
  207.    the version of Quixx, your hardware (including type of mouse & location),
  208.    and a copy of the application (in case I don't have it).  You can also
  209.    inform me of the problem via CompuServe.
  210.  
  211. 10. SOURCE CODE AVAILABILITY
  212.  
  213.    The assembly source is available on request.  It is several pages long and
  214.    includes four modules:
  215.  
  216.    1. TSR and DOS interface routines
  217.    2. QUIXX animation routines
  218.    3. Graphics routines/Expaned memory routines
  219.    4. Command line routines
  220.  
  221.    The code is well commented in most parts and can teach the reader about:
  222.  
  223.    .non-reentrant TSRs
  224.    .unloading TSRs
  225.    .accessing Video Memory/saving/restoring
  226.    .reading COM ports
  227.    .using Expanded and Extended Memory
  228.    .writing graphics algorithms
  229.    .reading/writing directly to the CGA/EGA/VGA graphics registers
  230.  
  231.    The program is free to use, copy, and distribute.  The source is only $15
  232.    and well worth it.  If interested write to:
  233.  
  234. Jonathan Kraidin
  235. 6100 City Line Avenue
  236. Apartment 1504
  237. Philadelphia, PA  19131
  238.  
  239. CIS 72571, 2122
  240.  
  241. Disclaimer:  The author of this program makes no guarentees to its function,
  242. compatibility with other software or lack of risk in its use.  While Quixx
  243. should not cause any problems, this program is executed at the users own risk
  244. and the author is not responsible for any damages, data loss or problems
  245. resulting directly or indirectly from its use.
  246.  
  247. In no event shall the author or distributers be liable for any damages
  248. whatsoever (including, without limitation, damages for loss of business
  249. profits, business interruption, loss of business information, or other
  250. pecuniary loss) arising out of the use of or inability to use this product,
  251. even if the author has been advised of the possibility of such damages.
  252.  
  253. Windows is a product of MicroSoft Corporation.
  254.